home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 027a / clipmen.zip / README < prev   
Text File  |  1991-11-15  |  4KB  |  92 lines
  1. You should now have three files. They are:
  2.  
  3.         README   (the file you are reading now)
  4.         MENU.PRG (source code)
  5.         MENU.OBJ (object form of above)
  6.  
  7. They were created by me, Ron Laska, for use in my day to day programming tasks.
  8. They have been of great service to me and I hope they can do the same for you.
  9. I have included the source code for those of you who might want or need to
  10. modify the functions.  If you feel that these functions have been of any value
  11. to you, I would greatly appreciate a small donation ($ 5.00).  If these
  12. functions are useless pieces of crap, I would like to know that also.
  13.  
  14. Please send any donations/correspondance to:
  15.  
  16.                         Ronald Laska
  17.                         1690 N. 1st Ave.  Apt. #2
  18.                         Melrose Park, IL  60160
  19.  
  20.  
  21. If you have any comments or improvements to the functions you can send a
  22. message to me on the EXEC-PC bulletin board under the name of MAP FINANCIAL.
  23.  
  24.  
  25. The file MENU.PRG contains six functions.  They are described below.
  26.  
  27.  
  28.  
  29.     -  FUNCTION messmenu( nTOP, nLEFT, nBOTTOM, nRIGHT, aCHOICES, [lESCTOEXIT],;
  30.                       [cBOXCOLOR], [cITEMSCOLOR], [cHIGHCOLOR] )
  31.  
  32.     This function will display a scrolling menu with a message tacked on
  33.     underneath the menu box.  Up and Down arrow keys move through the menu
  34.     item by item.  PageUp and PageDown move through the menu by pages.  Home
  35.     will take you to the top.  End will take you to the bottom.  Any
  36.     alphanumeric key will position the highlight bar on the item with a
  37.     matching first character.  If none match, the highlight will not move.
  38.     The array of choices must be set up as in the following example:
  39.  
  40.         LOCAL aCHOICES:={{"ITEM1","MESSAGE1"}
  41.                          {"ITEM2","MESSAGE2"}
  42.                          .
  43.                          .
  44.                          .
  45.                          {"ITEMn","MESSAGEn"}
  46.                         }
  47.  
  48.     An item is selected by pressing the enter key.  The function will return
  49.     the element number of the item selected.
  50.  
  51.  
  52.     -  FUNCTION checkmenu( nTOP, nLEFT, nBOTTOM, nRIGHT, aCHOICES, [cBOXCOLOR],;
  53.                        [cITEMSCOLOR], [cHIGHCOLOR] )
  54.  
  55.     This function will display a 'Check-Box' type menu.  The same movement keys
  56.     are active as in "messmenu."  'Checking' an item is done through the enter
  57.     key.  The function will return an array containing the element numbers
  58.     of the items selected.
  59.  
  60.  
  61.     -  FUNCTION newscrollbar( nTOP, nCOLUMN, nBOTTOM, cCOLOR, nSTARTPOS )
  62.  
  63.     This function is used in conjunction with 'displayscroll' and
  64.     'updatescroll' to display a vertical scroll bar.  This function must be
  65.     called before any calls to the other functions can be made.  The function
  66.     will return an array containing information that is needed by the other
  67.     functions.
  68.  
  69.  
  70.     -  FUNCTION displayscroll( aBARARRAY )
  71.  
  72.     This function draws the scroll bar on the screen.  This function should
  73.     only be called once usually right after a call to newscrollbar.
  74.     For example:
  75.  
  76.         displayscroll(newscrollbar(0,79,24,"GR+/R",1)
  77.  
  78.  
  79.     -  FUNCTION updatescroll( aBARARRAY, nCURRENTPOS, nTOTAL, lFORCEUPDATE )
  80.  
  81.     This function is used to update the scroll bar.  For examples of its use
  82.     see the source code.
  83.  
  84.  
  85.     - FUNCTION boxshadow( nTOP, nLEFT, nBOTTOM, nRIGHT )
  86.  
  87.     This function draws a drop-shadow around the lower right corner of an
  88.     object for that oh so popular '3-D' effect.
  89.     
  90.  
  91. *** REMEMBER - If you drink, don't drill.
  92.